home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Utilities / Text / OzTeX 1.9 / Read-Me
Text File  |  1995-12-11  |  12KB  |  265 lines
  1. Installation notes for OzTeX 1.9
  2. ================================
  3. Andrew Trevorrow, May 1995
  4. akt@kagi.com
  5.  
  6.  
  7. NOTE: I was planning to increase the shareware fees with this release
  8. but I've decided to keep the individual fee fixed at $30 for a bit longer.
  9. I have however increased the group fee to $300 but I will accept payments
  10. at the old rate of $150 until the end of May (1995!).  Note that if a
  11. university pays the group fee then all staff and students are covered for
  12. ALL future versions of OzTeX.
  13.  
  14.  
  15. CONTENTS:
  16. Introduction
  17. How to install OzTeX
  18. How to install dvips and Metafont
  19. How to print the OzTeX User Guide
  20. Important changes
  21. Choosing an editor
  22. A minimal OzTeX system
  23.  
  24.  
  25. Introduction
  26. ------------
  27.  
  28. OzTeX is a shareware implementation of TeX for the Macintosh.  This file
  29. explains how to install OzTeX and print out a copy of the OzTeX User Guide.
  30. OzTeX is normally distributed as a set of hqx files:
  31.  
  32. oztex.hqx    -- Contains OzTeX and OzTools (for 68020 and later Macs),
  33.                 the Correct file, and these folders:
  34.                 Configs, Help-files, TeX-docs and LaTeX-docs.
  35. oz68000.hqx  -- Contains OzTeX and OzTools for 68000 Macs (eg. Plus or SE).
  36. ozppc.hqx    -- Contains OzTeX and OzTools for PowerPC Macs.
  37. inputs.hqx   -- Contains the TeX-inputs folder.
  38. formats.hqx  -- Contains the TeX-formats folder.
  39. fonts.hqx    -- Contains the TeX-fonts folder.
  40. vf.hqx       -- Contains the VF-files folder.
  41. ps.hqx       -- Contains the PS-files folder.
  42. pk.hqx       -- Contains the PK-files folder.
  43. dvips.hqx    -- Contains Tom Kiffe's dvips (requires System 7).
  44. mf.hqx       -- Contains Tom Kiffe's Metafont (requires System 7).
  45. bbedit.hqx   -- Contains Rich Siegel's BBEdit Lite.
  46. anagrams.hqx -- Contains the Anagrams folder (an optional extra).
  47. register.hqx -- Contains the Register folder.
  48.  
  49. If you already have OzTeX 1.8 then you don't need to get all of these files.
  50. The files in fonts.hqx, vf.hqx, pk.hqx and bbedit.hqx have not changed.
  51. You must get oztex.hqx.  If you have a Power Mac then get ozppc.hqx.  If you
  52. have a Mac with a 68000 CPU then get oz68000.hqx.  The TeX-inputs folder has
  53. two new files (plain.tex and ltpatch.ltx) which have been used to create new
  54. versions of Plain.fmt and LaTeX.fmt in the TeX-formats folder.  Instead of
  55. getting inputs.hqx and formats.hqx, it would be quicker to get plain.tex and
  56. ltpatch.ltx from any CTAN site and then use INITEX to rebuild the formats.
  57. The PS-files folder has one new encoding file (BaKoMaCM.enc), so you only
  58. need to get ps.hqx if you intend to use the BaKoMa fonts (described below).
  59. New versions of dvips, Metafont, Anagrams and Register are included in 1.9,
  60. so you might want to get their corresponding hqx files.  Then again, it might
  61. be a lot simpler just to get everything!
  62.  
  63. The Register program provides an alternative way to pay for my programs.
  64. In particular, it allows for payment by credit card which should be cheaper
  65. and easier for people outside Australia.
  66.  
  67. PLEASE NOTE: There is a separate shareware fee for Tom Kiffe's programs.
  68. Send US$25 for a single user, or US$100 for a site license, to
  69.  
  70.    Thomas R. Kiffe
  71.    P.O. Box 516
  72.    College Station, Texas 77841
  73.    USA.
  74.  
  75. For more information, send e-mail to tkiffe@math.tamu.edu.  I hope all
  76. OzTeX users who make use of Metafont and/or dvips will support Tom's work.
  77. To save some space, I've created minimal versions of dvips and Metafont.
  78. The above shareware fee covers you for Tom's full CMacTeX distribution which
  79. is available at any CTAN site or mirror in /tex-archive/systems/mac/cmactex.
  80. (The main CTAN sites are ftp.shsu.edu, ftp.tex.ac.uk and ftp.dante.de.)
  81. CMacTeX contains a lot of other stuff that you might find useful.
  82.  
  83.  
  84. How to install OzTeX
  85. --------------------
  86.  
  87. If you already have an older version of OzTeX then you should install this
  88. new version in a new folder to avoid clobbering any of your own fonts,
  89. config files, TeX input files, etc.  Once you have the new version up and
  90. running you can merge in your own modifications.
  91.  
  92. Assuming you have enough disk space, carry out the following steps:
  93.  
  94. 1. Create a new folder on your hard disk and call it anything you like.
  95.    "OzTeX" would be a good choice!
  96.  
  97. 2. Unpack all the hqx files in the new folder.  If you use StuffIt Expander
  98.    then it might create "oztex Folder" as a result of unpacking oztex.hqx;
  99.    if so, move everything out of "oztex Folder" and trash the empty folder.
  100.    Other programs like Compact Pro or UnStuffIt will convert the hqx files
  101.    into self-extracting archives, so just double-click on the sea files.
  102.    Delete all hqx and sea files after everything has been unpacked.
  103.  
  104. 3. To check the installation, double-click on the Correct file.  This is a
  105.    TeachText/SimpleText document containing a picture of a correctly installed
  106.    OzTeX folder.  Make sure your new folder looks the same!
  107.  
  108. OzTeX should now be ready to run.
  109.  
  110.  
  111. How to install dvips and Metafont
  112. ---------------------------------
  113.  
  114. NOTE: If you have previously installed dvips and Metafont then all you need
  115. to do is replace the old versions of Tom's programs with the new versions.
  116. You should delete the new versions of tex.config, dvips.env and texmf.env.
  117.  
  118. Tom's programs require System 7.  To call Metafont from OzTeX you will need
  119. about 1.5Mb of free memory (after OzTeX has started).  To call dvips requires
  120. 1Mb of free memory, and for dvips to call Metafont then another 1.5Mb must be
  121. available.  Of course, if you don't have access to a PostScript printer
  122. then you can forget about dvips.
  123.  
  124. Before you can use dvips or Metafont you must carry out these steps:
  125.  
  126. 1. Move the tex.config file from either the Dvips or Metafont folder and
  127.    put it in your System's Preferences folder.  Delete the other copy of
  128.    tex.config (two copies are included in case people decide to get only
  129.    one of the folders).
  130.  
  131. 2. Edit dvips.env in the Dvips folder and change the HOME string from
  132.    "/HD/OzTeX" to a string indicating the full path name of your OzTeX
  133.    folder.  Note the use of "/" rather than ":".
  134.  
  135. 3. Edit texmf.env in the Metafont folder and change the HOME string from
  136.    "/HD/OzTeX" to the same string used above.
  137.  
  138. 4. Both .env files also contain a PASSWORD string.  After you pay Tom's
  139.    shareware fee he will send you the correct string to remove the
  140.    reminder dialogs.
  141.  
  142. 5. Like OzTeX, dvips needs to be told which fonts are PostScript fonts
  143.    (and which ones must be downloaded to the printer).  This information
  144.    is obtained from a file called psfonts.map in the ps sub-folder of Dvips.
  145.    I've set up psfonts.map so that it matches the list of PostScript fonts
  146.    at the end of OzTeX's Default config file.  If you use a different set of
  147.    PostScript fonts (like BaKoMa or CM/PS) then carry out these steps:
  148.    a. Edit psfonts.map and append (or prepend) the information I've provided
  149.       in psfonts.BaKoMa, psfonts.CMPS, psfonts.Lucida or psfonts.MathTime,
  150.       depending on which fonts you have.
  151.    b. Edit dvips.env and add the full path name for the location of your Mac
  152.       printer fonts (LWFN files) to the DVIPSHEADERS variable.  For example:
  153.       DVIPSHEADERS .:~/Dvips/ps:~/PS-files:/HD/System/Fonts
  154.  
  155.  
  156. How to print the OzTeX User Guide
  157. ---------------------------------
  158.  
  159. (Users of OzTeX 1.8 should note that the User Guide for 1.9 is very similar.
  160. All page breaks are the same and only the following DVI pages have changed:
  161. 1, 3, 6, 7, 9, 16, 25 and 42.)
  162.  
  163. 1. Start up OzTeX by double-clicking on the application.  It should load
  164.    the Default configuration file stored in the Configs folder, and an
  165.    encoding file.  If you get any warning messages about unknown folders
  166.    or files then you've made a mistake in the above installation.
  167.  
  168. 2. OzTeX is set up to print on A4 paper.  If your printer uses US Letter
  169.    paper then select "US Letter" from the Config menu.
  170.  
  171. 3. Select "Page Setup..." from the File menu and check that the paper size
  172.    and orientation are correct.
  173.  
  174. 4. If you are using a StyleWriter (or any 360 dpi printer) then select
  175.    the "StyleWriter" item in the Config menu.  If you have an ImageWriter
  176.    (or any 144 dpi printer) then select the "ImageWriter" item.
  177.  
  178. 5. Select "Print DVI..." from the File menu and open ozuser.dvi in the
  179.    LaTeX-docs folder.
  180.  
  181. 6. When the print dialog box appears, select suitable options (you might
  182.    want to reverse the page order if your printer stacks pages face up)
  183.    and click on the Print button.
  184.  
  185. Once the User Guide is printed you might like to read it!
  186.  
  187.  
  188. Important changes
  189. -----------------
  190.  
  191. - Native PowerPC versions of OzTeX and OzTools are provided.  Ditto for
  192.   Anagrams and Tom Kiffe's programs.
  193.  
  194. - All my programs now save user settings like window sizes and locations in
  195.   a preferences file.  Because the applications no longer modify themselves
  196.   they can be run from a read-only volume.
  197.  
  198. - Added support for the BaKoMa fonts created by Basil Malyshev.  The BaKoMa
  199.   package contains FREE PostScript and TrueType versions of Computer Modern.
  200.   The TrueType fonts can be used to make OzTeX's preview much more readable.
  201.  
  202. - When reading a list of PostScript fonts in a config file, OzTeX now checks
  203.   to see if a given TFM name already exists.  If it does then that entry is
  204.   updated with the remaining information on the line, otherwise a new entry
  205.   is added at the end of the current list.  This might trip up some people
  206.   who have relied on the fact that a config file could have the same TFM name
  207.   listed more than once and only the FIRST entry would be used by OzTeX.
  208.   Now the LAST entry will be used.
  209.  
  210. - Fixed a bug (introduced in 1.8) that could cause clipping problems on
  211.   non-PostScript printers.
  212.   
  213. - Fixed an incompatibility problem with After Dark 3.0.
  214.  
  215. For full details, select "Changes to OzTeX 1.8" from OzTeX's Help menu.
  216.  
  217.  
  218. Choosing an editor
  219. ------------------
  220.  
  221. OzTeX does not contain an integrated text editor.  Instead, Rich Siegel's
  222. BBEdit Lite is supplied.  The BBEdit Lite folder contains the application
  223. and its documentation.  You might prefer to use another editor.
  224. Pete Keleher's Alpha is a popular editor for TeX/LaTeX input files.
  225. I decided to distribute BBEdit Lite because it is free, much smaller
  226. than Alpha, and does not require System 7.  Another alternative for
  227. Unix fans is Eric Fisher's Mac Vim.
  228.  
  229. Nearly all the text files distributed with OzTeX are created by MPW
  230. (that's the editor I prefer to use).  Note that BBEdit Lite comes with a
  231. small application called TextChanger which lets you change the creator of
  232. all text files in a folder.
  233.  
  234. If you are using System 7 then one of the first things you should do
  235. after starting up OzTeX is select "Choose Editor" from the Edit menu.
  236. Use the standard file dialog to select the application you'll be using
  237. to edit your TeX/LaTeX input files.  If the application can receive Apple
  238. events then OzTeX will remember its name and location for later use.
  239.  
  240.  
  241. A minimal OzTeX system
  242. ----------------------
  243.  
  244. You might be running short of space on your hard disk, so let's consider the
  245. bare essentials needed for a working OzTeX system (before deleting any files
  246. it would be a good idea to save a backup copy):
  247.  
  248. - If you won't be creating any TFM or VF files then delete OzTools.
  249. - TeX-docs and LaTeX-docs contain important documentation and example files,
  250.   so don't remove any files from these folders until you've looked at them.
  251. - If you don't use LaTeX, delete the LaTeX sub-folder from TeX-inputs,
  252.   as well as the Graphics, PSNFSS and Tools sub-folders.
  253. - Delete any format files that you don't intend using from TeX-formats.
  254.   Don't delete TeX.pool though; it's needed by INITEX.
  255. - If you won't be using PostScript fonts then delete all files in the
  256.   VF-files folder and delete the PS sub-folder in TeX-fonts.
  257. - The BBEdit Lite folder can be deleted if you use a different text editor.
  258. - Delete the Dvips folder if you don't have access to a PostScript printer,
  259.   or you are still using System 6.
  260. - Delete the Metafont folder if you have a full set of TFM and PK files,
  261.   or you are still using System 6.
  262.  
  263.  
  264. Happy OzTeXing!
  265.